package com.lxk.service.cart.api;

import com.lxk.service.cart.param.CartAddParam;
import com.lxk.service.cart.param.CartResetParam;
import com.lxk.service.cart.param.CartUpdateParam;
import com.lxk.service.cart.param.CartUpdateSelectParam;
import com.lxk.service.cart.response.CartListRespVo;
import com.lxk.service.core.Result;

import java.util.Collection;

/**
 * 购物车 Service 接口
 *
 * @author huahua
 */
public interface CartServiceApi {

    /**
     * 添加商品到购物车
     *
     * @param userId 用户编号
     * @param param  添加信息
     * @return 购物项的编号
     */
    Result<Long> addCart(Long userId, CartAddParam param);

    /**
     * 更新购物车商品数量
     *
     * @param userId 用户编号
     * @param param  更新信息
     */
    Result<Boolean> updateCartCount(Long userId, CartUpdateParam param);

    /**
     * 更新购物车选中状态
     *
     * @param userId 用户编号
     * @param param  更新信息
     */
    Result<Boolean> updateCartSelected(Long userId, CartUpdateSelectParam param);

    /**
     * 重置购物车商品
     * <p>
     * 使用场景：在一个购物车项对应的商品失效（例如说 SPU 被下架），可以重新选择对应的 SKU
     *
     * @param userId     用户编号
     * @param resetParam 重置信息
     */
    Result<Boolean> resetCart(Long userId, CartResetParam resetParam);

    /**
     * 删除购物车商品
     *
     * @param userId 用户编号
     * @param ids    购物项的编号
     */
    Result<Boolean> deleteCart(Long userId, Collection<Long> ids);

    /**
     * 查询用户在购物车中的商品数量
     *
     * @param userId 用户编号
     * @return 商品数量
     */
    Result<Long> getCartCount(Long userId);

    /**
     * 查询用户的购物车列表
     *
     * @param userId 用户编号
     * @return 购物车列表
     */
    Result<CartListRespVo> getCartList(Long userId);
}
